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Mininet 应 用 与 源码 剖析 
Mininet 是 研究 软件 定义 网 络 ， 进 行 快速 验证 的 高 效 模拟 平台 。 


本 书 的 一 到 三 章 介绍 Mininet 的 安装 和 使 用 ; 第 四 章 介 绍 一 些 高 级 功能 ; 五 到 七 章 分 析 Mininet 的 源码 实 


现 。 
最 新 版 本 在 线 阅读 : GitBook。 
本 书 源码 在 Github 上 维护 ， 欢 迎 参与 : https://github.com/yeasy/mininet_book。 


感谢 所 有 的 贡献 者 。 
更 新 历史 : 


e 0.6: 2013-12-16 

o 完善 对 topo 模块 、net 模块 等 的 分 析 。 
e 0.5: 2013-12-11 

o 补充 对 部 分 example 文件 的 分 析 ; 

o 增加 对 clean 模块 的 分 析 。 
e 0.4: 2013-11-18 

o 补充 对 link 和 node 库 的 核心 代码 分 析 ; th 充 运 行文 件 分 析 。 
e 0.3: 2013-11-16 

o 完成 运行 文件 分 析 。 
e 0.2: 2013-11-15 

o 完成 库 文件 分 析 。 
e 0.1: 2013-10-11 

o 完成 代码 结构 分 析 。 


参加 步骤 


e {E GitHub 上 fork 到 自己 的 仓库 ， 如 user/mininet book ， 然 后 clone 到 本 地 ， 并 设置 用 户 信息 。 


$ git clone git@github.com:user/mininet_book.git 
$ cd mininet_book 

$ git config user.name "User" 

$ git config user.email user@email.com 


。 修改 代码 后 提交 ， 并 推送 到 自己 的 仓库 。 


$ #do some change on the content 
$ git commit -am "Fix issue #1: change helo to hello" 
$ git push 


e 在 GitHub 网 站 上 提交 pull request. 

。 定期 使 用 项 目 仓库 内 容 更 新 自己 仓库 内 容 。 `… $ git remote add upstream 
https://github.com/yeasy/mininet_book $ git fetch upstream $ git checkout master $ git rebase 
upstream/master $ git push -f origin master 


概述 


Stanford 大 学 Nick McKeown 教授 领导 的 研究 小 组 基于 Linux Container 架构 ， 开 发 出 了 这 套 进程 虚拟 化 
的 平台 。 在 Mininet 的 帮助 下 ， 你 可 以 轻易 的 在 自己 的 笔记 本 上 测试 一 个 软件 定义 网 络 (Software- 
Defined Networks) ， 对 基于 Openflow、Open vSwitch 的 各 种 协议 等 进行 开发 验证 ， 或 者 验证 自己 的 想 
法 8 


最 合 人 振奋 的 是 ， 所 有 的 代码 几乎 可 以 无 颖 迁移 到 真实 的 硬件 环境 中 。 在 实验 室 里 ， 一 行 命 合 就 可 以 创建 
一 个 支持 SDN 的 任意 拓扑 的 网 络 结构 ， 并 可 以 灵活 的 进行 相关 测试 ， 验 证 了 设计 的 正确 后 ， 又 可 以 轻 松 
部 署 到 真实 的 硬件 环境 中 。 目 前 Mininet 已 经 作为 官方 的 演示 平台 对 各 个 版 本 的 Openflow 协议 进行 演示 和 
测试 。 


Mininet 项 目的 首页 在 http://www.openflowswitch.org/foswiki/bin/view/OpenFlow/Mininet， 目 前 主要 维护 
者 为 Bob Lantz 跟 Brandon Heller。 讨 论 组 地 址 为 mininet-discuss@lists.stanford.edu. 


主要 特性 


Mininet 作为 一 个 轻 量 级 软 定义 网 络 研发 和 测试 平台 ， 其 主要 特性 包括 : 


支持 Openflow、OpenvSwitch 等 软 定义 网 络 部 件 
方便 多 人 协同 开发 

支持 系统 级 的 还 原 测 试 支持 复杂 拓扑 、 自 定义 拓扑 
提供 Python API 

很 好 的 硬件 移植 性 (Linux RE) ， 结 果 有 更 好 的 说 服 力 
高 扩展 性 ， 支 持 超过 4096 台 主 机 的 网 络 结构 


安装 
使 用 镜像 


下 载 


官方 网 站 已 经 提供 了 配置 好 相关 环境 的 基于 Debian Lenny 的 虚拟 机 镜像 ， 下 载 地 址 

为 http://openflowswitch.org/downloads/OpenFlowTutorial-081910.vmware.zip， 压缩 包 大 小 为 700 MB 
左右 ， 解 压 后 大 小 为 2.1 GB 左右 。 虚 拟 机 镜像 格式 为 Vmware 的 vmdk， 可 以 直接 使 用 vmware 
workstation 或 者 Virtualbox 等 软件 打开 。 如 果 使 用 QEMU 和 KVM 则 需要 先进 行 格式 转换 。 


如 果 使 用 Virtualbox 进行 加 载 ， 需 要 注意 尽量 使 用 最 新 版 本 ，host 操作 系统 需要 支持 PAE， 并 在 
Virtualbox 中 打开 PAE 支持 。 


使 用 


默认 用 户 名 密码 均 为 openflow， 建 议 通过 本 地 利用 ssh 登录 到 虚拟 机 上 使 用 (可 以 设置 自动 登录 并 将 X 重 
定向 到 本 地 ) ， 上 比较 方便 操作 。 

注意 事项 : 建议 将 guest 主机 采用 bridge 方式 联网 ， 以 获取 host 可 见 的 独立 IP ; 也 可 采用 为 guest 配置 
两 块 网 卡 方式 ， 一 块 采用 NAT (一 般 来 说 ，guest 上 看 到 为 eth0，IP 地 址 为 10.0.2.* ， 网 关 为 

10.0.2.2 ) ， 一 块 采 用 host-only (guest 上 的 eth1, IP 地 址 为 192.168.56.* ) ， 但 host-only 的 网 卡 可 


能 无 法 自动 dhcp 到 地 址 ， 需 要 手动 配置 (ifconfig eth1 ip/mask ) 将 host 机 .ssh 目录 下 id_rsa.pub 复制 
到 guest 机 的 .ssh 目录 下 ， 并 写 入 authorized_ keys， 可 实现 自动 登陆 认证 。 


本 地 安装 


大 部 分 发 行 版 中 已 经 带 有 该 软件 包 ， 直 接 通过 命令 安装 即 可 。 例 如 ， 在 Ubuntu Rah, WT 
$ sudo aptitude install -y mininet 
也 可 以 通过 源 代 码 安装 。 


$ git clone https://github.com/mininet/mininet.git 
$ cd mininet 


参考 INSTALL 文件 中 针对 不 同 操作 系统 的 安装 步骤 。 


基本 使 用 


通过 几 个 简单 例子 来 介绍 Mininet 的 基本 功能 。 


创建 网 络 


Mininet 的 操作 十 分 简单 ， 启动 一 个 小 型 测试 网 络 只 需要 下 面 几 个 步骤 。 登录 到 虚拟 机 命令 行 界面 ， 打 开 
wireshark， 使 其 后 台 运 行 , 命令 为 sudo wireshark & o 


启动 Mininet， 命 命 为 sudo mn ， 则 默认 创建 如 下 图 所 示 的 网 络 拓扑 。 


“ee 
SEE 


经 过 短暂 的 等 待 即 可 进入 以 mininet> 引导 的 命令 行 界面 。 好 了 ， 从 现在 开始 ， 我 们 就 拥有 了 一 个 1 台 控 
制 节点 (controller)、 一 台 交 换 (switch)、 两 台 主 机 (host) 的 网 络 ， 并 且 用 wireshark 进行 观测 。 


mininet> nodes 
available nodes are: 
EOMh2Zh3isl 


查看 链 路 信息 : 


mininet> net 
sl <-> h2-ethO h3-ethO 


输出 各 节点 的 信息 : 


mininet> dump 

c0: IP=127.0.0.1 intfs= pid=1679 

s1: IP=None intfs=sl-eth1,sl-eth2 pid=1682 
h2: IP=10.0.0.2 intfs=h2-ethO pid=1680 

h3: IP=10.0.0.3 intfs=h3-ethO pid=1681 


对 节点 进行 单独 操作 
如 果 想 要 对 某 个 节点 的 虚拟 机 单独 进行 命令 操作 ， 也 十 分 简单 ， 命 令 格 式 为 node cmd 。 


例如 查看 交换 机 s1 上 的 网 络 信息 135 我 们 只 需要 在 执行 的 ifconfig 命令 前 加 上 s1 主机 标志 即 可 ， 即 s1 
ifconfig ， 同 样 ， 如 果 我 们 想 用 ping 3 个 包 的 方法 来 测试 h2 跟 h3 之 间 连 通 情况 ， 只 需要 执行 h2 ping -c 
3 h3 即 可 。 得 到 的 结果 为 





mininet> h2 ping -c 3 h3 

PING 10.0.0.3 (10.0.0.3) 56(84) bytes of data. 

64 bytes from 10.0.0.3: icmp_seq=1 ttl=64 time=7.19 ms 

64 bytes from 10.0.0.3: icmp_seq=2 ttl=64 time=0.239 ms 

64 bytes from 10.0.0.3: icmp_seq=3 ttl=64 time=0.136 ms 

— 10.0.0.3 ping statistics — 

3 packets transmitted, 3 received, 0% packet loss, time 2006ms 
rtt min/avg/max/mdev = 0.136/2.523/7.194/3.303 ms 


在 本 操作 执行 后 ， 可 以 通过 wireshark 记录 查看 到 创建 新 的 流 表 项 的 过 程 ， 这 也 是 造成 第 一 个 ping 得 到 的 
结果 偏 大 的 原因 。 


更 简单 的 全 网 络 互 ping 测试 命令 是 pingall ， 会 自动 所 有 主机 节点 逐 对 进行 ping 连通 测试 。 


快捷 测试 
除了 cli 的 交互 方式 之 外 ，Mininet 还 提供 了 更 方便 的 自动 执行 的 快捷 测试 方式 ， 其 格式 为 sudo mn --test 


cmd ， 即 可 自动 启动 并 执行 cmd 操作 ， 完 成 后 自动 退出 。 


例如 sudo mn --test pingpair ， 可 以 直接 对 主机 连通 性 进行 测试 ， sudo mn --test iperf 启动 后 直接 进行 性 
能 测试 。 用 这 种 方式 很 方便 直接 得 到 实验 结果 。 





自 定义 拓扑 
Mininet 提供 了 Python APl， 可 以 用 来 方便 的 自 定义 拓扑 结构 。 


在 mininet/custom 目录 下 给 出 了 几 个 例子 。 例 如 在 topo-2sw-2host.py 文件 中 定义 了 一 个 mytopo， 则 可 
以 通过 --topo 选项 来 指定 使 用 这 一 拓扑 ， 命 邻 为 sudo mn --custom ~/mininet/custom/topo-2sw-2host.py 
--topo mytopo --test pingall 。 


同样 的 ， 我 们 可 以 通过 下 面 的 Python 脚本 来 完成 对 一 个 2 层 tree 拓扑 网 络 的 测试 。 


from mininet.net import Mininet 

from mininet.topolib import TreeTopo 
tree4 = TreeTopo(depth=2,fanout=2) 
net = Mininet(topo=tree4) 

net.start() 

h1, h4 = net.hosts[0], net.hosts[3] 
print h1l.cmd(‘ping -c1 %s' % h4.IP()) 
net.stop() 


使 用 友好 的 MAC 编号 


默认 情况 下 ， 主 机 跟 交 换 机 雇 动 后 分 配 的 MAC 地 址 是 随机 的 ， 这 在 某 些 情况 下 不 方便 查找 问题 。 


可 以 使 用 -mac 选项 ， 这 样 主机 跟 交 换 机 分 配 到 的 MAC 地 址 跟 他 们 的 ID 是 一 致 的 ， 容 易 通过 MAC 地 址 
较 快 找到 对 应 的 节点 。 


使 用 XTerm 

为 了 能 够 正确 使 用 xterm， 我 们 需要 做 些 准备 工作 。 在 这 里 推荐 利用 远程 方式 登录 到 OpenflowVM。 
客户 端 

对 于 自 带 X 的 Linux 主机 ， 无 需 配置 X。 


如 果 客 户 端 是 Windows 主机 ， 需 要 先 在 Windows 机 器 上 安装 Xserver (Xming) 。 下 载 地 
tit : http://sourceforge.net/projects/xming/files/Xming/6.9.0.31/Xming-6-9-0-31-setup.exe. 


如 果 你 使 用 secureCRT 远程 登录 到 OpenflowVM， 需 要 在 “会 话 选 项 ->SSH2-> 密 钥 交 换 " 下 ， 取 消 diffie- 
hellman-group14 和 diffie-hellman 选择 ; 同时 在 “远程 /X11" 下 ， 选 择 转 发 “X11 数据 包 (F) ”; 点 击 确 
定 。 


开启 Xming， 使 用 如 下 命令 远程 到 Openflow VM 即 可 。 
ssh -X openflow@[Guest IP here] 


如 果 你 使 用 puTTY 远程 登录 到 OpenflowVM: Az “puTTY->Connection->SSH->X11", i&7%“X11 
forwarding->Enable X11 forwaring” ; 开启 Xming， 点 击 Windows 开始 按钮 ， 在 运行 栏 输入 "cmd"， 打 开 
终端 ， 输 入 cd <dir> 切换 到 保存 puTTY 的 目录 下 ; 使 用 下 面 的 命令 远程 登录 到 openflow VM. 


putty.exe -X openflow@[Guest IP here] 
主机 端 
通过 使 用 -x 参数 ，Mininet 在 启动 后 会 在 每 个 节点 上 自动 打开 一 个 XTerm， 方 便 某 些 情况 下 的 对 多 个 节 
点 分 别 进行 操作 。 命 兮 关 


sudo mn -X 


在 进入 mn cli 之 后 ， 也 可 以 使 用 xterm node 命令 指定 启动 某 些 节点 上 的 xterm， 例 如 分 别 启 用 s1 跟 h2 
上 的 xterm， 可 以 用 


xterm s1 h2 


链 路 操作 

在 Mininet cli 中 ， 使 用 link MP, RAR EARRA, AA 
link nodel node2 up/down 

例如 临时 禁用 s1 BR h2 之 间 的 链 路 ， 可 以 用 


link sl h2 down 


指定 交换 机 跟 控制 器 类 型 
通过 --switch 选项 跟 --controller 选项 可 以 分 别 指定 采用 哪 种 类 型 的 交换 机 跟 控制 器 。 


例如 使 用 用 户 态 的 交换 机 : 
sudo mn --switch user 
使 用 OpenvSwitch : 
sudo mn --switch ovsk 


使 用 NOX pyswitch : 


。 首先 确保 NOX 运行 


cd $NOX_CORE_DIR 
.nox core -v -i ptcp: 


然后 Ctrl-c %36 NOX 进程 
e 然后 指定 NOX 交换 机 


sudo -E mn --controller nox_pysw 


注意 : 通过 -E 选项 来 保持 预定 义 的 环境 变量 (此 处 为 NOX_CORE DIR) o 


名 字 空 间 


默认 情况 下 ， 主 机 节点 有 用 独立 的 名 字 空 间 (namespace) ， 而 控制 节点 跟 交 换 节 点 都 在 根 名 字 空 间 
(root namespace) 中 。 


如 果 想 要 让 所 有 节点 拥有 各 自 的 名 字 空 间 ， 需 要 添加 --innamespace 参数 ， 即 启动 方式 为 sudo mn -- 


innamespace 。 


注意 : 为 了 方便 测试 ， 在 默认 情况 下 ， 所 有 节点 使 用 同一 进程 空间 ， 因 此 ， 在 h2 跟 h3 RA sl 上 使 用 
ps 查看 进程 得 到 的 结果 是 一 致 的 ， 都 是 根 名 字 空 间 中 的 进程 信息 。 


启动 参数 总 结 


e -h, --help 打印 帮助 信息 

e --switch=SWITCH 交换 机 类 型 ， 包 括 [kernel user ovsk] 

e --host=HOST 模拟 主机 类 型 ， 包 括 [process] 

e --Controller=CONTROLLER 控制 器 类 型 ， 包 括 [nox_dump none ref remote nox_pysw] 

e --topo=TOPO,argl,arg2….argN 指定 自 带 拓扑 ， 包 括 [tree reversed single linear minimal] 
e -c, -clean 清理 环境 

e --custom=CUSTOM 使 用 自 定义 拓扑 和 节点 参数 

e --test=TEST 测试 命 舍 ， 包 括 [cli build pingall pingpair iperf all iperfudp none] 

e -x, --xterms 在 每 个 节点 上 打开 xterm 

e --mac 让 MAC 地 址 跟 DP ID 相同 

e -arp 配置 所 有 ARP 项 

e -v VERBOSITY, --verbosity=VERBOSITY [info warning critical error debug output] 输出 日 志 级 别 
e --ip=IP 远 端 控制 器 的 IP 地 址 

e --port=PORT 远 端 控制 器 监听 端口 

e --innamespace 在 独立 的 名 字 空 间 内 

e --listenport=LISTENPORT 被 动 监 听 的 起 始 端口 

e -nolistenport 不 使 用 被 动 监听 端口 

e --pre=PRE 测试 前 运行 的 CLI 脚本 

e --post=POST 测试 后 运行 的 CLI 脚本 


K 


ath gA 
弟 用 命令 总 结 


G 


e hep RIGIMMARTIH, AHMARAN BAMA 

e dump 打印 节点 信息 

e gterm 给 定 节点 上 开启 gnome-terminal。 注 : 可 能 导致 Mininet 崩溃 
e xterm 给 定 节点 上 开启 xterm 

e intfs 列 出 所 有 的 网 络 接口 

e iperf 两 个 节点 之 间 进 行 简 单 的 iperf TCP 测 试 

e iperfudp 两 个 节点 之 间 用 指定 带宽 udp 进行 测试 

e net 显示 网 络 链接 情况 

e noecho 运行 交互 式 窗口 ， 关 闭 回应 (echoing) 

e pingpair 在 前 两 个 主机 之 间 互 ping 测试 

e source 从 外 部 文件 中 读 人 命 兮 

e dpctl 在 所 有 交换 机 上 用 dptcl 执行 相关 命令 ， 本 地 为 tcp 127.0.0.1:6634 
e link 禁用 或 启用 两 个 节点 之 间 的 链 路 

e nodes 列 出 所 有 的 节点 信息 

e pingall 所 有 host 节点 之 间 互 ping 

。 py 执行 Python 表达 式 

e sh 运行 外 部 shell 命令 

e quit/exit 退出 


其 他 操作 


执行 sudo mn -c 会 进行 清理 配置 操作 ， 适 合 故障 后 恢复 。 执行 exit 会 退出 Mininet 的 CLI， 同 时 给 出 运 
行 时 间 统 计 。 py cmd 使 用 Python 来 执行 cmd. 测试 Mininet 启动 后 立刻 关闭 的 时 间 可 以 用 sudo mn -- 


test none 。 


TO} 


LA 
级 功能 
本 章 将 通过 一 个 具体 管理 Openflow switch 的 例子 来 介绍 一 些 比较 高 级 的 命令 。 


首先 ， 和 启动 Mininet， 执 行 
sudo mn --topo single,3 --mac --switch ovsk --controller remote 


生成 一 个 小 的 网 络 ， 三 台 主 机 连 到 一 台 交 换 机 上 ， 交 换 机 为 OpenvSwitch 交换 机 ， 指 定 remote 类 型 控制 
器 (默认 为 本 地 ) 。 


使 用 dpctl 
执行 
dpctl show tcp:127.0.0.1:6634 


可 以 查看 到 交换 机 的 端口 等 基本 情况 ， 其 中 tcp 端口 6634 是 默认 的 交换 机 监听 端口 。 


执行 
dpctl dump-flows tcp:127.0.0.1:6634 


可 以 看 到 更 详细 的 流 表 信息 。 此 时 ， 流 表 为 空 ， 执 行 h2 ping h3 无 法 得 到 响应 。 因 此 我 们 需要 通过 dpctl 
手动 添加 流 表 项 ， 实 现 转发 。 命令 为 


dpctl add-flow tcp:127.0.0.1:6634 in_port=1,actions=output:2 
dpctl add-flow tcp:127.0.0.1:6634 in_port=2,actions=output:1 


此 时 查看 流 表 可 以 看 到 新 的 转发 信息 ， 同 时 可 以 在 h2 和 h3 之 间 ping Ñ. 


Oo 
控制 器 
通过 执行 
sudo mn --controller=remote --ip=[controller IP] --port=[controller listening port] 


可 以 连接 到 控制 器 。 


交换 机 与 控制 器 交互 


我 们 可 以 启动 一 个 简单 的 控制 器 ， 默 认 没 有 任何 流 表 项 ， 仅 仅 作 为 一 台 带 学 习 功 能 的 交换 机 。 控 制 器 默认 
监听 端口 是 6633。 


以 下 控制 器 与 交换 机 之 间 的 消息 交互 过 程 ， 可 以 通过 wireshark， 配 置 of 过 滤器 观察 到 交换 机 跟 控 制 器 之 
间 的 交互 消息 VENo 参见 见 下 面 的 表格 。 


消息 类 型 描述 
Hello Controller->Switch RÆ TCP 握手， 控制 器 发 送 它 的 版 本 号 到 交换 机 。 
Hello Switch->Controller 交换 机 回复 它 支 持 的 版 本 。 
Features Request Controller->Switch 控制 器 询问 可 用 端口 。 
Set Config Controller->Switch 控制 器 让 交换 机 发 送 流 超时 消息 
Features Reply Switch->Controller 交换 机 回复 端口 、 端 口 速度 、 支 持 的 表 和 行动 。 


同样 ， 我 们 可 以 用 wireshark 观察 到 当 第 一 次 有 ping AM h2 发 到 h3 时 ， 控 制 器 如 何 自动 添加 相应 的 表 
项 到 交换 机 。wireshark 相应 的 过 滤器 为 of && (of.type != 3) && (of.type != 2) o 


相关 的 消息 过 程 参 考 下 面 的 表格 。 | 消息 | 类 型 | 描述 | | -- | -- | -- | | Packet-In | Switch->Controller | Wa 
到 达 交 换 机 ， 没 有 发 生 匹配 ， 发 送 到 控制 器 。| | Packet-Out | Controller->Switch | 从 交换 机 端口 发 出 包 。| 
| Flow-Mod | Controller->Switch | 添加 指定 流 。| | Flow-Expired | Switch->Controller | 流 超时 。| 


使 用 NOX 


首先 确定 没有 其 他 控制 器 在 运行 (占据 6633 端口 ) 
sudo killall controller 

启动 Mininet 
sudo mn --topo single,3 --mac --switch ovsk --controller remote 

然后 启动 NOX， 默 认 路 径 为 ~/noxcore/build/src， 重 新 打开 一 个 ssh 终端 执行 
./Nox_core -v -i ptcp: pytutorial 


会 自动 打开 运行 tutorial 应 用 的 NOX， 打 印 出 详细 的 调试 信息 ， 并 监听 6633 端口 。 


直到 打印 出 类 似 如 下 信息 ， 说 明 交 换 机 已 经 成 功 连接 到 NOX, 
00039|nox|DBG:Registering switch with DPID = 1 


通过 互 ping 测试 ， 各 个 主机 连通 ， 此 时 switch 等 同 于 一 个 hub, 然后 通过 修改 
~/noxcore/src/nox/coreapps/tutorial/pytutorial.py 中 代码 ， 让 NOX 工作 成 一 个 带 学 习 功 能 的 交换 机 。 相 关 
命令 参考 ofinclude 代码 ， 以 及 NOX 对 各 个 包 的 解析 代码 目录 : ~/noxcore/src/nox/lib/packet/。 


通过 编写 NOX 程序 ， 我 们 可 以 让 交换 机 的 行为 更 加 智能 化 、 复 条 化 。 为 了 测试 我 们 编写 的 NOX EF, R 
们 可 以 使 用 cbench 来 进行 测试 。 


外 部 读 取 配置 命令 


可 以 写 到 一 个 文件 中 ， 用 Mininet 直接 调用 。 例 如 脚本 文件 名 为 my_cli_script， 则 可 以 执行 
mininet> source my_cli_script 
或 者 


# mn --pre my_cli_script 


代码 结构 


介绍 源 代 码 的 基本 结构 。 


运行 相关 


。 bin/mn 主 运 行文 件 ， 安 装 后 执行 mn 即 调 用 的 本 程序 ， 是 Python 程序 。 


e mnexec.c 执行 一 些 快 速 命 售 ， 比 如 关闭 文件 描述 符 等 ， 是 C 程序 ， 编 译 后 生成 二 进 制 文件 mnexec 
被 Python 库 调用 。 


RHA 


e INSTALL : 安装 说 明 
e setup.py : 安装 Python 包 时 候 的 配置 文件 ， 被 Makefile 中 调用 。 
e debian/ : 生成 deb 安装 包 时 的 配置 文件 。 


核心 代码 
核心 代码 基本 都 在 mininet/ 子 目录 下 。 TE: 最 新 的 2.1.0 版 本 ， 核 心 Python 代码 仅 为 4675 行 。 


$ find mininet -name "*.py" | xargs cat | wc -| 


说 明文 件 


e CONTRIBUTORS : 作者 信息 
。 README.md : 主 说 明文 件 
e doc/doxygen.cfg : 执行 doxygen 生 成 文档 时 的 配置 文件 。 


HE 


-~ 


e LICENSE 
e custom/ 目录 下 可 以 放 一 些 用 户 自 定 义 的 Python 文件 ， 比 如 自 定 义 的 拓扑 类 等 。 


e test) 目录 下 是 一 些 测试 的 例子 。 

util/ 

目录 下 是 一 些 辅助 文件 ， 包 括 安装 脚本 、 文 档 辅 助 生 成 等 ， 重 要 的 文件 包括 : 
e m bash 脚本 提供 用 户 直接 在 host 执行 命令 的 接口 。 例 如 


m host cmd args... 


m 通过 调用 mnexec 来 实现 对 Mininet 中 的 元 素 执 行 相应 的 命令 。 
。 mnexec C 程序 ， 通 过 参数 绑 定 到 某 个 名 字 空 间 ， 并 执行 给 定 的 命令 。 


整体 逻辑 功能 
整体 上 来 看 ，Mininet 作为 一 个 基于 Python 的 网 络 模拟 工具 ， 可 以 分 为 两 大 部 分 : Python 库 和 运行 文件 。 


前 者 提供 对 网 络 中 元 素 进 行 抽象 和 实现 ， 例 如 定义 主机 类 来 表示 网 络 中 的 一 台 主 机 。 后 者 则 基于 这 些 库 来 
完成 各 种 自 定义 的 模拟 过 程 。 一 个 典型 的 场景 如 下 图 所 示 。 


root namespace 


raw raw 
socket socket 





TCP/SSL 
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host h2 namespace host h3 namespace 





mininet.link 模块 


描述 链 路 相关 的 接口 和 连接 。 包 括 Intf 类 、Link 类 、TCIntf 类 和 TCLink 类 。 


mininet.link.Intf 


表示 基本 的 网 络 接口 ， 比 如 h1-eth0 表示 host 1 上 的 eth0 接口 。 属性 包括 所 在 的 节点 ， 名 称 ， 所 接 的 
link, mac/ip 信息 等 。 构造 的 时 候 会 传人 节点 、 端 口 等 属性 ， 并 绑 定 接口 到 对 应 的 节点 的 端口 上 。 


def init__(self, name, node=None, port=None, link=None, **params ): 
"""name: interface name (e.g. hl-eth0) 
node: owning node (where this intf most likely lives) 
link: parent link if we're part of a link 
other arguments are passed to config()""" 
self.node = node 
self.name = name 
self.link = link 
self.mac, self.ip, self.prefixLen = None, None, None 
# Add to node (and move ourselves if necessary ) 
node.addIntf( self, port=port ) 
# Save params for future reference 
self.params = params 
self.config( **params ) 


所 支持 的 方法 包括 配置 macip 等 配置 方法 ， 大 都 是 通过 ifconfig 命令 在 对 应 节点 上 调用 cmd 方 法 来 实现 。 
此 外 ， 还 提供 了 config) 方法 来 一 次 性 配置 所 有 的 属性 。 


mininet.link.Link 


表示 基本 的 一 条 链 路 ， 最 基本 的 链 路 在 mininet 中 其 实 就 是 一 对 veth 接口 对 。 


def init__(self, nodel, node2, portl=None, port2=None, 
intfName1=None, intfName2=None, 
intf=Intf, clsl=None, cls2=None, params1=None, 
params2=None ): 
"""Create veth link to another node, making two new interfaces. 
nodel: first node 
node2: second node 
port1: nodel port number (optional) 
port2: node2 port number (optional) 
intf: default interface class/constructor 
cls1, cls2: optional interface-specific constructors 
intfNamel: nodel interface name (optional) 
intfName2: node2 interface name (optional) 
params1: parameters for interface 1 
params2: parameters for interface 2""" 
# This is a bit awkward; it seems that having everything in 
# params would be more orthogonal, but being able to specify 
# in-line arguments is more convenient! 
if portl is None: 
portl = nodel.newPort() 
if port2 is None: 
port2 = node2.newPort() 
if not intfNamel: 
intfNamel = self.intfName( nodel, port1 ) 
if not intfName2: 
intfName2 = self.intfName( node2, port2 ) 


self.makelntfPair( intfNamel, intfNamez2 ) 


if not cls1: 
cls1 = intf 
if not cls2: 
cls2 = intf 
if not paramsl: 
params1 = {} 
if not params2: 
params2 = {} 


intfl = cls1( name=intfNamel1, node=nodel, port=port1, 
link=self, **params1 ) 

intf2 = cls2( name=intfName2, node=node2, port=port2, 
link=self, **params2 ) 


# All we are is dust in the wind, and our two interfaces 
self.intf1, self.intf2 = intf1, intf2 


创建 链 路 时 ， 需 要 在 两 个 节点 上 分 别 生成 两 个 端口 ， 利 用 节点 和 端口 ， 获 取 对 应 的 两 个 网 络 接口 的 名 称 ， 
例如 s1-ethO 和 h1-eth0， 然 后 调用 makelntfPair() 方法 ， 最 终 调 用 util.py 中 的 makelntfPair() 方法 ， 调 
用 系统 中 的 ip link 命令 来 创造 一 对 veth pair. 


def makelntfPair( intf1, intf2 ): 
"""Make a veth pair connecting intfl and intf2. 
intfl: string, interface 
intf2: string, interface 
returns: success boolean""" 
# Delete any old interfaces with the same names 
quietRun( 'ip link del ' + intf1 ) 
quietRun( 'ip link del ' + intf2 ) 
# Create new pair 
cmd = 'ip link add name ' + intfl + ' type veth peer name ' + intf2 
return quietRun( cmd ) 


mininet.link. TCIntf 


被 TC (Linux 下 的 traffic control 的 工具 ) BELO, DUBS. WR, ZR, RAIK 


mininet.link. TCLink 


表示 一 对 对 称 的 TC 接口 连接 到 一 起 。 


mininet.node 模块 


节点 模块 表示 网 络 中 的 基本 元 素 (包括 主机 、 交 换 机 和 控制 器 ) ， 十 分 关键 。 


其 中 ， 每 个 主机 默认 在 一 个 单独 的 名 字 空 间 中 ， 交 换 机 和 控制 器 都 在 root 名 字 空 间 中 。 


其 类 
从 
即 mininet.node.Node， 表示 一 个 基本 的 虚拟 网 络 节点 ， 是 所 有 的 网 络 节点 的 父 类 。 


实现 上 其 实 就 是 在 网 络 名 字 空 间 中 的 一 个 shell 进 程 ， 可 以 通过 各 种 管道 进行 通信 。 该 类 是 模块 中 其 他 类 的 
根本 ， 其 它 类 都 是 直接 或 间接 继承 。 


节点 包括 名 称 、 是 否 在 网 络 名 字 空 间 、 接 口 、 端 口 等 可 能 的 属性 。 
init 


params: Node parameters (see config() for details)""" 


# Make sure class actually works 
self.checkSetup() 


self.name = name 
self.inNamespace = inNamespace 


# Stash configuration parameters for future reference 
self.params = params 


self.intfs = {} # dict of port numbers to interfaces 
self.ports = {} # dict of interfaces to port numbers 

# replace with Port objects, eventually ? 
self.nametointf = {} # dict of interface names to Intfs 


# Make pylint happy 
( self.shell, self.execed, self.pid, self.stdin, self.stdout, 
self.lastPid, self.lastCmd, self.pollOut ) = ( 
None, None, None, None, None, None, None, None ) 
self.waiting = False 
self.readbuf = " 


# Start command interpreter shell 
self.startShell() 


初始 化 函数 主要 进行 参数 的 初始 化 ， 之 后 通过 调用 startShell() 启动 一 个 shell 进 程 (该 进程 默认 关闭 描述 
符 ， 并 从 ty 上 分 离开 来 ) ， 等 待 接受 传人 的 命令。 句柄 被 发 送 给 self.shell E, 


addlntf 


def addintf( self, intf port=None ): 
"""Add an interface. 
intf: interface 
port: port number (optional, typically OpenFlow port number)""" 
if port is None: 
port = self.newPort() 
self.intfs[ port ] = intf 
self.ports[ intf ] = port 
self.nameTolntf[ intf.name ] = intf 
debug( '\n' ) 
debug( ‘added intf %s:%d to node %s\n' % ( intf, port, self.name ) ) 
if self.inNamespace: 
debug( 'moving’, intf, ‘into namespace for’, self.name, ‘\n' ) 
movelntf( intf.name, self ) 


添加 一 个 接口 (比如 <intfhi-etho> ) 到 节点 上 ， 如 果 给 定 了 port (比如 0 ) ， 则 建立 端口 到 接口 的 映 
射 关 系 。 这 个 映射 关系 通过 self.intfs 和 self.ports 两 个 字典 来 分 别 维护 。 


cmd 


该 酌 数 能 在 节点 所 在 的 进程 shell 上 执行 输入 的 命令 。 


def cmd( self, *args, **kwargs ): 
"""Send a command, wait for output, and return it. 
EmdsSthinGmen 
verbose = kwargs.get( 'verbose’, False ) 
log = info if verbose else debug 
log( '*** %s : %s\n' % ( self.name, args ) ) 
self.sendCmd( *args, **kwargs ) 
return self.waitOutput( verbose ) 


config 


ci MAC, IP 3 default Route 信息 。 


def config( self, mac=None, ip=None, 
defaultRoute=None, lo='up', **_params ): 
"""Configure Node according to (optional) parameters: 
mac: MAC address for default interface 
ip: IP address for default interface 
ifconfig: arbitrary interface configuration 
Subclasses should override this method and call 
the parent class's config(**params)""" 
# If we were overriding this method, we would call 
# the superclass config method here as follows: 
# r = Parent.config( **_params ) 
Pau 
self.setParam( r, 'setMAC', mac=mac ) 
self.setParam(r, 'setIP', ip=ip ) 
self.setParam( r, 'setDefaultRoute', defaultRoute=defaultRoute ) 
# This should be examined 
self.cmd( ‘ifconfig lo ' + lo ) 
return r 


connectionsTo 


返回 所 有 从 自身 连接 到 给 定 节 点 的 接口 ， 即 [intf1, intf2... ]。 


def connectionsTo( self, node): 
"Return [ intfl, intf2... ] for all intfs that connect self to node." 
# We could optimize this if it is important 
connections = [] 
for intf in self.intfList(): 
link = intf.link 
if link: 
nodel, node2 = link.intfl.node, link.intf2.node 
if nodel == self and node2 == node: 
connections += [ ( intf, link.intf2 ) ] 
elif nodel == node and node2 == self: 
connections += [ ( intf, link.intf1 ) ] 
return connections 


主机 类 
包括 Host 和 CPULimitedHost 两 个 类 。 


mininet.node.Host 


表示 一 个 主机 节点 ， 目 前 跟 Node 类 定义 相同 。 在 主机 类 上 执行 命令 可 以 通过 Cmd() 或 者 sendCmd() 5 
法 ， 前 者 会 等 待命 合 的 输出 结果 ， 后 者 会 直接 返回 ， 并 人 允许 使 用 后 续 的 monitor() 来 进行 监视 跟踪 。 


mininet.node.CPULimitedHost 
继承 自 Host 类 ， 通 过 cgroup 工具 来 对 CPU 进行 限制 。 
init 


def init__(self, name, sched='cfs', **kwargs ): 
Host.__ init__(self, name, **kwargs ) 
# Initialize class if necessary 
if not CPULimitedHost.inited: 
CPULimitedHost.init() 
# Create a cgroup and move shell into it 
self.cgroup = 'cpu,cpuacct,cpuset:/' + self.name 
errFail( 'cgcreate -g ' + self.cgroup ) 
# We don't add ourselves to a cpuset because you must 
# specify the cpu and memory placement first 
errFail( 'cgclassify -g cpu,cpuacct:/%s %s' % ( self.name, self.pid ) ) 
# BL: Setting the correct period/quota is tricky, particularly 
# for RT. RT allows very small quotas, but the overhead 
# seems to be high. CFS has a mininimum quota of 1 ms, but 
# still does better with larger period values. 
self.period_us = kwargs.get( 'period_us', 100000 ) 
self.sched = sched 
self.rtprio = 20 


控制 器 类 


mininet.node.Controller 

控制 器 基 类 。 默 认 的 控制 器 是 一 个 参考 的 实现 ，controller。 
表示 一 个 控制 器 节点 。 包 括 IP 地 址 、 端 口 等 。 

主要 方法 包括 启动 和 停止 一 个 控制 器 。 

init 


def init__(self, name, inNamespace=False, command='controller', 

cargs='-v ptcp:%d', cdir=None, ip="127.0.0.1", 
port=6633, **params ): 

self.command = command 

self.cargs = cargs 

self.cdir = cdir 

self.ip = ip 

self.port = port 

Node. _init_( self, name, inNamespace=inNamespace, 

ip=ip, **params ) 
self.cmd( ‘ifconfig lo up' ) # Shouldn't be necessary 
self.checkListening() 


checkListening 
确保 系统 中 安装 了 telnet， 并 且 在 监听 端口 上 并 没有 其 他 控制 器 在 监听 。 


Start 


def start( self ): 
"""Start <controller> <args> on controller. 
Log to /tmp/cN.log""" 
pathCheck( self.command ) 
cout = '/tmp/' + self.name + '.log' 
if self.cdir is not None: 
self.cmd( 'cd ' + self.cdir ) 
self.cmd( self.command + '' + self.cargs % self.port + 
'1>' + cout +'2>'+ cout + '&') 
self.execed = False 


该 方法 检查 控制 器 程序 存在 ， 并 根据 传人 的 参数 来 启动 它 。 


stop 


def stop( self ): 
"Stop controller." 
self.cmd( ‘kill %' + self.command ) 
self.terminate() 


该 方法 杀 死 控制 器 进程 和 节点 的 shell 进程 ， 并 执行 清理 工作 。 


mininet.node.NOX 


表示 一 个 NOX 控制 器 (需要 系统 中 事先 安装 了 NOX). 


mininet.node.OVSController 


表示 一 个 ovs-controller (需要 系统 中 实现 安装 了 ovs-controller) 。 


mininet.node.RemoteController 


表示 一 个 在 Mininet 控制 外 的 控制 器 ， 即 用 户 自己 额外 运行 了 控制 器 ， 此 处 需要 维护 连接 的 相关 信息 。 


mininet.node.Switch 

表示 一 个 交换 机 的 基 类 。 

运行 在 root 名 字 空 间 。 主 要 包括 dpid、listenport 等 属性 。 
mininet.node.IVSSwitch 


表示 一 台 indigo 交换 机 (需要 系统 中 已 存在 ) 。 


mininet.node.OVSLegacyKernelSwitch 


传统 的 openvswitch 交换 机 ， 基 于 ovs-openflowd。 不 推荐 。 


mininet.node.OVSSwitch 


表示 一 台 openvswitch 交换 机 (需要 系统 中 已 经 安装 并 配置 好 openvswitch) ， 基 于 ovs-vsctl 进行 操作 。 
目前 所 谓 的 OVSKernelSwitch 实际 上 就 是 OVSSwitch 


mininet.node.UserSwitch 


用 户 态 的 openflow 参考 交换 机 ， 即 ofdatapath。 不 推荐 。 


mininet.net 模块 


主要 包括 Mininet 和 MininetWithControlNet 两 个 类 。 


mininet.net.Mininet 

模拟 一 个 Mininet 中 的 网 络 ， 包 括 拓扑 、 交 换 机 、 主 机 、 控 制 器 、 链 路 、 接 口 等 。 其 中 最 主要 的 部 分 是 
build() 范 数 ， 依 次 执行 : 根据 拓扑 创建 网 络 ， 配 置 网 络 名 字 空间 ， 配 置 主机 的 IP、MAC 等 信息 ， 检 查 是 
否 启 动 xterm， 是 否 配置 自动 静态 arp 等 。 


init 


inNamespace=False, 
autoSetMacs=False, autoStaticArp=False, autoPinCpus=False, 
listenPort=None ): 
"""Create Mininet object. 
topo: Topo (topology) object or None 
switch: default Switch class 
host: default Host class/constructor 
controller: default Controller class/constructor 
link: default Link class/constructor 
intf: default Intf class/constructor 
ipBase: base IP address for hosts, 
build: build now from topo? 
xterms: if build now, spawn xterms? 
cleanup: if build now, cleanup before creating? 
inNamespace: spawn switches and controller in net namespaces? 
autoSetMacs: set MAC addrs automatically like IP addresses? 
autoStaticArp: set all-pairs static MAC addrs? 
autoPinCpus: pin hosts to (real) cores (requires CPULimitedHost)? 
listenPort: base listening port to open; will be incremented for 
each additional switch in the net if inNamespace=False""" 
self.topo = topo 
self.switch = switch 
self.host = host 
self.controller = controller 
self.link = link 
self.intf = intf 
self.ipBase = ipBase 
self.ipBaseNum, self.prefixLen = netParse( self.ipBase ) 
self.nextIP = 1 # start for address allocation 
self.inNamespace = inNamespace 
self.xterms = xterms 
self.cleanup = cleanup 
self.autoSetMacs = autoSetMacs 
self.autoStaticArp = autoStaticArp 
self.autoPinCpus = autoPinCpus 
self.numCores = numCores() 
self.nextCore = 0 # next core for pinning hosts to CPUs 
self.listenPort = listenPort 


self.hosts = [] 

self.switches = [] 

self.controllers = [] 

self.nameToNode = {} # name to Node (Host/Switch) objects 
self.terms = [] # list of spawned xterm processes 
Mininet.init() # Initialize Mininet if necessary 

self.built = False 


if topo and build: 
self.build() 


该 方法 主要 根据 传人 参数 配置 相关 的 数据 结构 。 如 果 还 通过 参数 执行 了 拓扑 信息 ， 则 执行 build 方法 ， 
buildFromTopo 方法 来 根据 拓扑 信息 创建 节点 和 相关 的 连接 等 。 


buildFromTopo 


调用 


def buildFromTopo( self, topo=None ): 
"""Build mininet from a topology object 
At the end of this function, everything should be connected 
and Up 


# Possibly we should clean up here and/or validate 
# the topo 
if self.cleanup: 

pass 


info( '*** Creating network\n' ) 


if not self.controllers and self.controller: 
# Add a default controller 
info( '*** Adding controller\n' ) 
classes = self.controller 
if type( classes ) is not list: 
classes = [ classes ] 
for i, cls in enumerate( classes ): 
self.addController( 'c%d' % i, cls ) 


info( '*** Adding hosts:\n' ) 

for hostName in topo.hosts(): 
self.addHost( hostName, **topo.nodelnfo( hostName ) ) 
info( hostName + '') 


info( '\n*** Adding switches:\n' ) 

for switchName in topo.switches(): 
self.addSwitch( switchName, **topo.nodelnfo( switchName) ) 
info( switchName + '') 


info( '\n*** Adding links:\n' ) 
for srcName, dstName in topo.links(sort=True): 
src, dst = self.nameToNode[ srcName ], self.nameToNode[ dstName ] 
params = topo.linkInfo( srcName, dstName ) 
srcPort, dstPort = topo.port( srcName, dstName ) 
self.addLink( src, dst, srcPort, dstPort, **params ) 
info( '(%s, %s) ' % ( src.name, dst.name ) ) 


info( ‘\n' ) 


mininet.net.MininetWithControlNet 


继承 自 Mininet 类 ， 主 要 用 于 在 使 用 用 户 态 datapath 的 时 候 模 拟 一 个 控制 器 网 络 ， 即 连接 用 户 态 的 交换 机 
和 用 户 态 的 控制 器 。 


mininet.topo 模块 


维护 网 络 拓扑 相关 的 信息 。 


除了 一 些 固定 结构 的 拓扑 类 之 外 ， 还 提供 了 mininet.topolib 模块 ， 提 供用 户 自己 创建 复杂 拓扑 相关 的 库 ， 
目前 仅 包 括 一 个 mininet.topolib.TreeTopo 拓扑 ， 是 个 树 拓扑 类 ， 给 定 深度 和 广度 可 以 自己 生成 相应 的 标 
准 树 拓扑 。 


mininet.topo.MultiGraph 


表示 一 个 图 结构 。 <M Site BE) 的 概念 。 主 要 维护 节点 、 边 信息 。 在 MultiGraph 中 ， 节 点 
就 是 一 个 序号 ， 边 则 通过 节点 和 节点 所 对 应 的 连接 列表 中 元 素来 表示 。 节 点 和 节点 的 连接 列表 的 对 应 关系 
通过 字典 结构 来 维护 。 





init 


def __init_( self ): 
self.data = {} 


图 结构 最 主要 的 功能 就 是 维护 一 个 字典 。Key fim, value 是 该 节点 所 连接 的 所 有 的 其 他 节点 的 列表 。 


add_node 
def add_node( self, node ): 
"Add node to graph" 
self.data.setdefault( node, [] ) 


添加 一 个 节点 ， 实 际 上 就 是 添加 一 个 key 到 data 字典 中 。 


add _ edge 
def add_edge( self, src, dest ): 
"Add edge to graph" 
src, dest = sorted( ( src, dest ) ) 
self.add_node( src ) 
self.add_node( dest ) 
self.data[ src ].append( dest ) 


添加 一 条 边 ， 实 际 上 就 是 添加 两 个 节点 ， 然 后 将 连接 信息 放 到 data 字典 中 (需要 注意 的 是 一 条 边 的 信息 仅 
被 保存 了 一 次 ， 即 放 到 序号 较 小 的 节点 对 应 的 list 中 ) 。 





mininet.topo. Topo 


拓扑 基 类 ， 默 认 的 拓扑 图 被 multigraph 类 维护 ， Pi ae 连接 信息 等 。 主 要 的 方法 就 是 添加 节 
点 、 连 接 等 。 Topo 中 一 个 node 实际 上 就 是 图 结构 中 的 一 点 ， 一 个 port 是 全 局 维护 增长 的 源 和 目的 
node 所 对 应 的 序号 ， 而 连接 








init 


def _ init__(self, hopts=None, sopts=None, lopts=None): 
"""Topo object: 
hinfo: default host options 
sopts: default switch options 
lopts: default link options""" 
self.g = MultiGraph() 
self.node_info = {} 
self.link_info = {} # (src, dst) tuples hash to Edgelnfo objects 
self.hopts = {} if hopts is None else hopts 
self.sopts = {} if sopts is None else sopts 
self.lopts = {} if lopts is None else lopts 
self.ports = {} # ports[src][dst] is port on src that connects to dst 


addNode 


def addNode(self, name, **opts): 
"""Add Node to graph. 
name: name 
opts: node options 
returns: node name""" 
self.g.add_node(name) 
self.node_info[name] = opts 
return name 


添加 节点 方法 被 添加 主机 addHost、 交 换 机 addSwitch, #2425 addController 等 方法 使 用 。 


该 方法 在 图 上 添加 一 个 节点 ， 然 后 添加 对 应 的 节点 信息 到 拓扑 的 参数 上 。 


addPort 


def addPort(self, src, dst, soort=None, dport=None): 

‘Generate port mapping for new edge. 
@param src source switch name 
@param dst destination switch name 
self.ports.setdefault(src, {}) 
self.ports.setdefault(dst, {}) 
# New port: number of outlinks + base 
src_base = 1 if self.isSwitch(src) else 0 
dst_base = 1 if self.isSwitch(dst) else 0 
if sport is None: 

sport = len(self.ports[src]) + src_base 
if dport is None: 

dport = len(self.ports[dst]) + dst_base 
self.ports[src][dst] = sport 
self.ports[dst][src] = dport 


addPort 会 同时 创建 源 和 目标 节点 上 的 端口 号 信息 。 拓扑 中 所 有 的 port 都 被 self.ports 结构 维护 ， 其 中 


ports[src][dst] 表示 在 src 节点 上 的 port， 该 port 所 在 link 连接 到 dst 节点 。 添加 一 个 port 就 是 更 新 了 这 
些 信 息 。 


addLink 


def addLink(self, nodel, node2, port1=None, port2=None, 
OPES): 
"""nodel, node2: nodes to link together 
port1, port2: ports (optional) 
opts: link options (optional) 
returns: link info key""" 
if not opts and self.lopts: 
opts = self.lopts 
self.addPort(nodel, node2, port1, port2) 
key = tuple(self.sorted([node1, node2])) 
self.link_info[key] = opts 
self.g.add_edge(*key) 
return key 


添加 一 条 连接 实际 上 就 是 添加 对 应 的 两 个 port， 并 在 图 上 添加 上 边 。 


mininet.topo.LinearTopo 


表示 一 个 线 行 拓扑 ， 交 换 机 连接 成 一 条 链 ， 每 个 交换 机 上 挂 裁 相等 个 数 的 主机 。 


mininet.topo.SingleSwitchTopo 


单个 交换 机 上 挂 载 若干 主机 ， 主 机 序号 按照 从 小 到 大 的 顺序 依次 挂 载 到 交换 机 的 各 个 端口 上 。 


mininet.topo.SingleSwitchReversedTopo 


单个 交换 机 上 挂 载 若干 主机 ， 主 机 序号 按照 从 大 到 小 的 顺序 依次 挂 载 到 交换 机 的 各 个 端口 上 。 


mininet.cli 模块 


主要 包括 CLI 类 ， 该 类 继承 自 Python 库 的 Cmd 类 。 

提供 对 CLI 的 支持 ， 创 建 Mininet 的 bash， 接 受 通过 bash 传输 的 Mininet 命令 ， 形 成 可 以 进行 交互 的 
Mininet 命令 行 环境 。 

主要 方法 包括 初始 化 之 后 提供 一 个 界面 ， 通 过 Python 库 的 Cmd 类 的 cmdloop() 方法 不 断 执行 输入 的 命 


今 。 这 些 命 令 可 以 是 指定 对 某 个 节点 进行 的 操作 或 者 是 对 Mininet 对 象 本 身 。 


对 于 大 部 分 对 Mininet 对 象 的 操作 命令 xxx， 会 调用 Python 库 的 Cmd 类 的 onecmd() 方法 来 执行 ， 该 方 
法 会 对 应 调用 do_xxx 方法 。 


各 个 do_xxx 方法 分 别 用 于 执行 支持 的 命令 。 例 如 do_dpctl() 方法 响应 用 户 输入 dpctl HAMS. Baa 
dpctl, dump, EOF, exit, gterm, help, intfs, iperf, iperfudp, link, net, nodes, noecho, pingall, 
pingallfull, pingpair, pingparifull, px, py, quit, sh, source, time, x, xterm 等 。 


mininet.clean 模块 


提供 对 执行 Mininet 后 的 清理 工作 ， 主 要 包括 cleanup) HA, ARAE EAMT sh() 函数 。 


cleanup() HRES ARAB we, NICH, X11 tunnel， 人 额外 的 内 核 态 datapath，ovs 
datapath，ip link 等 。 


实现 过 程 主要 是 通过 调用 subprocess 模块 〈 主 要 用 于 执行 外 部 命令 和 程序 ) 中 的 Popen 类 中 方法 来 对 进 


程 发 送 指 倒 。 


def sh( cmd ): 
"Print a command and send it to the shell" 
info( cmd + ‘\n' ) 
return Popen( [ '/bin/sh', '-c', cmd ], stdout=PIPE ).communicate()[ 0 ] 


communicate() 是 Popen 对 象 的 一 个 方法 ， 该 方法 会 阻塞 父 进 程 ， 直 到 子 进程 完成 。 通过 指定 
stdout=PIPE， 可 以 通过 stdout 获取 程序 的 返回 值 。 通 过 列表 传人 要 执行 的 命 合 和 参数 。 


mininet.log 模块 


利用 logging 包 ， 主 要 提供 进行 log 相关 的 功能 ， 包 括 三 个 类 : MininetLogger, 


StreamHandlerNoNewline. 

mininet.log.MininetLogger 

自 定义 的 logger 类 。 提供 输出 log、 配 置 LogLevel 功能 。 
mininet.log.Singleton 

软件 设计 模式 ， 限 定 所 创建 的 类 只 能 有 一 个 实例 。 供 MininetLogger 使 用 。 


mininet.log.StreamHandlerNoNewline 


自动 添加 换行 和 对 流 进行 格式 化 ， 供 MininetLogger 使 用 。 


Singleton、 


mininet.moduledeps 模块 


定义 几 个 对 Linux 系统 中 内 核 模 块 进行 操作 的 函数 ， 包 括 列 出 模块 l smod， 移 除 模 块 rmmod， 探 测 模块 
modprobe 和 处 理 模块 的 依赖 等 。 


mininet.term 模块 


支持 term 相关 的 命令 ， 例 如 在 主机 上 创建 一 个 xterm, 实现 依赖 于 socat 和 xterm, 


mininet.util 模块 


一 些 辅助 的 方法 。 包 括 如 下 重要 的 方法 。 


e errFail 利用 errRun (利用 popen RE shell 中 执行 命令 ) 来 执行 一 个 命 舍 ， 并 且 如 果 执 行 不 成 功 则 抛 


Bo 


运行 代码 和 示例 


mn 
该 脚本 定义 了 一 个 MininetRunner 类 ， 用 来 表示 模拟 网 络 的 主 程序 。 
主要 过 程 是 创建 一 个 MininetRunner() 实例 ， 依 次 解析 传 和 参数， 进行 初始 化 后 开启 网 络 。 


整体 过 程 如 下 图 所 示 。 





Constructions 





其 中 Mininet 类 的 start() 方法 是 核心 的 启动 过 程 ， 主 要 包括 调用 build 方法 来 根据 拓扑 创建 网 络 、 控 制 
器 、 交 换 机 、 主 机 和 连接 等 。 之 后 依次 启动 控制 器 和 交换 机 进程 。 在 执行 完 start) 之 后 ， 通 过 test 参数 来 
判断 mininet 运行 的 模式 。 


if test == 'none': 

pass 

elif test == ‘all’: 
mn.start() 
mn.ping() 
mn.iperf() 

elif test == 'cli': 
CLI( mn ) 

elif test != 'build': 
getattr( mn, test )() 


默认 情况 下 ， 参 数 为 cli， 即 进入 到 控制 台 模式 ， 人 允许 用 户 自己 输入 对 Mininet HERVE D. 最 终 执行 
mininet.stop() 进行 删除 资源 的 工作 。 


示例 程序 


Mininet 代码 中 带 有 了 大 量 的 示例 程序 ， 供 大 家 参考 和 理解 代码 。 所 有 的 示例 程序 都 在 example 目录 下 ， 
包括 


baresshd.py: 


使 用 Mininet 的 中 层 API 来 在 一 个 namespace 中 创建 主机 、 链 路 ， 并 在 主机 上 启动 sshd 进程 ， 让 用 户 可 
以 登录 。 并 未 使 用 OpenFlow。 


consoles.py: 
为 每 一 个 节点 都 创建 一 些 console 窗口 ， 并 人 允许 用 户 对 这 些 节点 进行 操作 和 观测 ， 支 持 图 形 界面 。 
controllers.py: 
使 用 一 个 自 定义 的 Switch() 子 类 ， 创 建 一 个 带 有 多 个 控制 器 的 网 络 。 
controllers2.py: 
创建 一 个 拥有 多 个 控制 器 的 网 络 ， 通 过 创建 空 的 网 络 ， 添 加 节点 和 手动 启动 交换 机 实现 。 
controlnet.py: 
通过 创建 两 个 mininet 对 象 来 建 模 一 个 控制 网 络 和 数据 网 络 。 
Cpu. py: 
在 不 同 的 CPU 限制 下 测试 iperf 的 带宽 性 能 。 
emptynet.py: 
演示 创建 一 个 空 的 网 络 ， 之 后 添加 节点 进去 。 
hwintf.py: 
添加 一 个 接口 〈 例 如 一 个 物理 接口 ) 到 一 个 网 络 中 。 
limit.py: 
演示 如 何 使 用 link 和 CPU 限制 。 
linearbandwidth. py: 
基于 Topo 创建 一 个 拓扑 子 类 ， 并 进行 简单 的 测试 。 
miniedit.py: 


通过 一 个 图 形 界 面 的 编辑 器 来 创建 网 络 。 


multiping. py: 


使 用 node.monitor() 来 检测 多 个 主机 的 输出 。 


multipoll.py: 


伟 测 多 个 主机 的 输出 文件 。 


multitest. py: 
创建 一 个 网 络 ， 并 在 其 上 进行 多 个 测试 。 
nat.py: 


将 Mininet 的 网 络 通过 nat 连接 到 外 部 网 络 中 。 


popen. py: 


使 用 host.popen() 和 pmonitor() 来 检测 多 个 主机 。 


popenpoll.py: 


使 用 node.popen() 和 pmonitor() 检测 多 个 主机 的 输出 。 


scratchnet.py, scratchnetuser.py: 


使 用 底层 的 Mininet 函数 来 创建 网 络 。 


simpleperf.py: 


配置 网 络 和 CPU、 带 宽 限 制 等 。 


sshd. py: 


在 每 个 主机 里 面 运行 一 个 sshd 进程 ， 使 得 用 户 可 以 通过 ssh 来 访问 主机 。 这 需要 将 Mininet 的 数据 网 络 连 
EE root 名 字 空 间 的 一 个 接口 上 上。 一般 的 ， 控 制 网 络 已 经 在 root 名 字 空 间 了 ， 所 以 默认 已 经 被 连接 。 


tree1024.py: 


创建 一 个 1024 主机 的 网 络 ， 然 后 运行 CLI。 根 据 系 统 资源 情况 ， 可 


treeping64. py: 


创建 一 个 64 主机 的 树 状 网 络 ， 利 用 ping 来 检查 连通 性 。 


要 利用 sysctl 进行 相关 修改 。 


